package com.service;

import com.bean.Book;
import com.utils.PageInfo;

import java.util.List;

public interface BookService {
    /**
     * 根据书籍 ID 查询书籍信息
     * @param id 书籍的唯一标识
     * @return 包含分类信息的书籍对象，如果未找到则返回 null
     */
    Book getBookById(Integer id);

    /**
     * 根据关键字进行分页模糊查询书籍信息
     * @param keyword 用于模糊查询的关键字
     * @param pageNum 当前页码
     * @param pageSize 每页显示的记录数量
     * @return 包含分页信息的书籍列表
     */
    PageInfo<Book> getBooksByKeyword(String keyword, int pageNum, int pageSize);

    /**
     * 根据类别 ID 进行分页查询书籍信息
     * @param categoryId 书籍所属类别的唯一标识
     * @param pageNum 当前页码
     * @param pageSize 每页显示的记录数量
     * @return 包含分页信息的该类别下的书籍列表
     */
    PageInfo<Book> getBooksByCategoryId(Integer categoryId, int pageNum, int pageSize);

    /**
     * 插入一本新的书籍信息
     * @param book 包含书籍详细信息的对象
     * @return 插入操作是否成功，成功返回 true，失败返回 false
     */
    boolean insertBook(Book book);

    /**
     * 根据书籍 ID 更新书籍的相关信息
     * @param book 包含要更新的书籍信息的对象，其中 ID 用于定位要更新的记录
     * @return 更新操作是否成功，成功返回 true，失败返回 false
     */
    boolean updateBook(Book book);

    /**
     * 根据书籍 ID 从数据库中删除对应的书籍信息
     * @param id 要删除的书籍的唯一标识
     * @return 删除操作是否成功，成功返回 true，失败返回 false
     */
    boolean deleteBookById(Integer id);
}